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I. IN TEO D DCTI ON 



A. RAMTEK AND DI-3000 RELATIONSHIP 

The Naval Postgraduate School's Secure Wargaming 
Analysis and Research Laboratory (War Lab), located in 
Ingersol Hall room IN-157, is equipped with a high resolu- 
tion graphics system. This system consists of six Ramtek 
GM859C color monitor screens, four 9460 controllers, and a 
Precision Visuals Incorporated DI-3000 graphics software 
system as modified by Lawrence Livermore Laboratories. The 
DI-3000 runs on a EEC VAX 11-780 using the VMS operating 
system. 

The purpose for writing this tutorial is to provide 
first-time users in the War Lab with an introductory level 
guide to using the Ramtek/DI-3000 graphics system, and to 
serve as a departure point fcr programmers wishing to make 
use cf the extensive capabilities documented in Reference 1. 
The facility is available for student and faculty use. 

DI-3000 is a device-independent software package. This 
independence theoretically enables a user to display 
graphics output on any type of standard graphics device if 
it is connected to a DI-3000 supported computer system. 
Because the DI-3000 system does not support all Ramtek 
features, and because some DI-3000 routines do not work as 
indicated in Reference 1, another purpose of this guide is 
to document these differences. 

The DI-3000 graphics software package is convenient and 
easy to use. The only background a programmer needs is an 
elementary knowledge of Fortran and the ability to create 
and run a program on the VAX 11-780. This is because 
DI-3000 is merely a library of Fortran-callable subroutines. 
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in application program calls DI-3000 subroutines to generate 
graphics images on one or more of the Ramtek monitors. 

The remainder of this chapter provides definitions and 
conventions , and explains general system use in broad terms. 
Bore detailed documentation is given in subsequent chapters. 

B. L1BCBATGRT EQUIPHENT OVERVIE® 

The secure laboratory as typically configured is shown 
in Figure 1.1. Variations to this layout occur periodi- 
cally, tut of interest is the location of the six Ramtek 
monitors. it present, only three unique images can be 
displayed between these six monitors because of current 
hardware constraints. For example, monitor pair A and B may 
display an identical image, monitor pair C and D may share a 
second image, and monitor pair E and F a third image. Each 
user specifies within their program the monitor pair to be 
used to display their graphics output. Only three programs 
can display their images on the three monitor pairs at the 
same time. 

By energizing just one of the monitors in a pair, for 
example, i but not B, a single image will appear on A 
instead of duplicates on both A and B. A further descrip- 
tion of how to specify and identify monitors is found in 
Chapter V. 

The VT- 100 or VT-102 terminals are the most convenient 
for use in conjunction with graphics programming. They are 
equipped with edit function keys and are located near the 
Ramtek monitor screens and the input graphic tablets. The 
easiest way to get started in the laboratory is to obtain an 
account on the VAX system from the War Lab Hanager and 
review the laboratory familiarization handout written by 
LCDR BcCcy. Copies of this handout are available in the War 
Lab. completing the CAI Tutorial is also helpful so that 
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unique features of the VAX editor can be used to create 
DI-3000 Fortran programs. The CAI tutorial is an interac- 
tive program found on the VAX system. Its beginning 
instructions will appear on the terminal screen immediately 
after log-in. 

C. RUNNING A PROGRAB 

After a Fortran program file is created that consists of 
DI-3000 subroutine calls which display a graphics image, the 
file must be compiled, linked to DI-3000, then run in three 
distinct steps. Assume you have created a program file 
identified as PICTUR E.FOR; 5 , and you wish to run the program 
and display the image on a Ramtek monitor. First you would 
type 

FOR PICTURE 

This command would compile your latest version Fortran file, 
here number 5, named PICTURE. If compilation were 

successful, the command prompt 

$ 

would appear. If net, errors would result. To link the 
DI-3000 operating system to your program you would next type 

SLINK PICTURE 

If there were no errors in your use of DI-3000, you would 
again see the command prompt. Then you would run the 
program by typing 

RUN PICTURE 

Figure 1.2 is an example of the control commands and screen 
returns that will he displayed when successfully running 
PICTURE. FOR;5 with no errors. Notice that there are five 
compilation warnings listed. These are normal system 
responses. If other than these warnings are listed, you 
have generated an error condition either in your use of 
DI-3000 or during the compilation and run phase of your 
Fortran program. 
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Once a program has been successfully run at least once# 
an object file is created. Any time the user would then 
desire to display the image, only •'running" the program 
would be necessary. For our previous example, only the 
command 

HUN PICTURE 

would be required. 

D. INITIALIZATION OVEBVIEW 

The fundamental DI-300 0 subroutine calls define p ri mi - 
tive objects and images such as lines, polygons, moves to a 
new screen position, written text, and more. There are 
three classes of primitives: polylines , polygo ns . and text . 

Polyline primitives fcrm "open-ended" figures, while polygon 
primitives form "enclosed" ones. Text primitives generate 
written character information. A more detailed description 
of primitives and their applications can be found in 
Chapters II, III, and 17. 

Every DI-3000 pregram must also consist of other subrou- 
tine calls necessary for these image primitives to be 
created, displayed, or terminated. For the programmer's 
purposes, this means that each program must have a certain 
minimum sequence of commands for it to run successfully. 
Figure 1.3 is an example of a DI-3000 program harness that 
will display a picture if the image primitive calls are 
surrounded by the commands listed. These commands are a 
minimum cf the calls a programmer can use, and provide a 
good reference for the beginning user. A full explanation 
cf each can be found in Chapter V. 

B. PBIMITI7ES AND CCBPOUHD IMAGES 

To create, say, a polygon primitive we would call a 
DI-3000 Forrran subroutine, named JPOLGN, as follows: 

CALL JPOLGN (X,Y,N) 
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These 



Notice the existence of subroutine parameters X,Y,N. 
parameters mean the following: 

X - The X coordinate positions (real array) 

Y - The Y coordinate positions (real array) 

N - Number of points defining a polygon (integer) 

Also f notice that subroutine parameters are of varying 
types (real array and integer) . In accordance with Fortran 
convention, this means parameters must be declared and 
dimensioned correctly at the beginning of your program. 
Real, integer, and array parameters are discussed further in 
Paragraph G below. A complete description of the subroutine 
JPOLGN can be found in Chapter II. 

The degree of complexity of an object being created 
determines the complexity of its primitive call. Objects 
such as polygons are many-sided, can have different interior 
and edge colors, and different interior intensities. These 
characteristics of a primitive are examples of its attri - 
bute s. Notice that we did not specify the attributes of the 
polygon when we called JPOLGN above, therefore we would have 
no way of knowing characterist ics like what color polygon we 
would create or what the interior pattern would be. we must 
insure that these attributes are correctly defined. There 
exist, for this purpose, attribute subroutines that are 
normally invoked prior tc primitive subroutines. For 
example, to insure a solid interior pattern for all subse- 
guent polygons, we would include in our program the 
following subroutine call: 

CALL JPINTR ( 1) 

This attribute subroutine and others that are commonly used 
are discussed in detail in Chapter III. 

Seldom is any image created that merely consists of a 
single primitive shape. Rather, most images are composites 
of several primitives that build upon each other to create 
the final desired picture. Most of the differences between 
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the way the DI-3000 system is supposed to work and the 
actual results obtainable in the War Lab are encountered 
when the programmer tries to create and display compound 
image segments. A discussion of the differences, their 
limitations, and ways to achieve desired outputs are 
described in Chapter VI. 

F. ABSOLUTE AND RELATIVE COORDINATES 

EI-3000 subroutines create images for display at a 
defined location on an output device. Most primitive 
subroutine calls can create images based upon either abso - 
lut e cr relative coordinate positions. When an image is to 
be created only once, use of either absolute or relative 
positioning is appropriate depending on the user's applica- 
tion and preference. But when multiple copies of an image 
are desired, it would be needlessly repetitive to redefine 
each primitive image for each different position, therefore 
relative referenced primitives are used. Rather than using 
absolute coordinates the relative primitive creates an image 
at X,I positions relative to an imaginary, unseen marker on 
the screen. For example, to duplicate an image you would 
establish the marker, call the relative primitive, move the 
marker, call the relative primitive again, and repeat this 
sequence until all images were created. 

Primitives of absolute and relative parameters can be 
distinguished from each other by their formats. Absolute 
primitives are of the form: 

JXXXXX (e.g. JPOLGN) 
while relative primitives are of the form: 

JBXXXX (e.g. JRPLGN) 

Almost every attribute and capability of both are identical, 
except fcr the coordinate position differences. 
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G. CCNVEHTIOHS 



1 . Genera l 

Throughout this tutorial. Reference 1 terminology 
and format has been maintained so that the programmer can 
use both documents inter changably when creating Ramtek 
graphics images. Answers to questions regarding standard 
VAX Fortran convention can be found in Reference 2, located 
in the War lab. 

2. D ispla y Coo rdinate Systems 

All images are referenced to a world and a virtual 
coordinate system. For our purposes, we will define the 
world coordinate system to be ±10.0 units in the horizontal 
(X) direction, and ±8.0 units in the vertical (Y) direction. 
Therefore, the program grid is a rectangular display area 
20.0 units wide by 16.0 units high. Except for maintaining 
the height-to-w idt h ratio of a Ramtek GM859C monitor (.8 to 
1.0) , cur choice cf dimensions is completely arbitrary. 
Whenever a primitive image is defined in our program, it 
will be referenced tc our 16.0 by 20.0 unit world coordinate 
grid . 

We will also use the entire available Ramtek monitor 
screen surface. This virtual coordinate system relative to 
screen center will be a rectangular grid ±1.0 unit wide by 
±.8 units high. 

Cur DI-3000 program will "translate, " or "map" our 
world coordinate picture onto the virtual coordinate screen 
by using the JWINDO command to specify world coordinate axis 
values, and the JVSPAC command for virtual coordinate 

values. The use of these commands is described in Chapter 

V. 
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3 . Subrou t i nes and Par a mete rs 

Each DI-3000 subroutine will be described in the 
section appropriate to the image type created. Each call 
will be briefly described as to function and result, and its 
parameters will then be listed and defined as to meaning and 
type. The correct specification for real number, integer, 
and array variables within a DI-3000 Fortran program 
follows : 

Integer--A whole number (no decimal point) 

Real Number--A number with a decimal point. 

Array--A group of contiguous storage locations asso- 
ciated with a single symbolic name [Ref. 2]. It must be 
dimensioned at the beginning of the Fortran program, and it 
can be integer or real as declared. 

Integers and real numbers can also be variable names 
referencing integer and real numbers, respectively. 

4. Cur ren t Position 

Primitives use and often modify the c urre nt position 
(CP) , a world coordinate point that determines a "starting 
point." Unless otherwise specified, a description of a 
primitive subroutine call will assume the return of the CP 
to its position prior to the call. 

If the CP is placed outside the defined coordinate 
area, distorted images may result when a drawing attempt 
encounters a defining screen edge. In general, unless 
special effects are desired, it is best to insure all 
created images will "fit" on the screen. 

5 . Attributes 

Attributes associated with a primitive subroutine 
call will be listed by attribute clas s. Recall, primitives 
are classified as polylines, polygons, or text and their 
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attributes are specified based upon these primitive types. 
System default settings (settings that are initialized if no 
attribute is specified) are also found in Chapter III. 
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Figure 1.1 Typical War Lab Configuration. 
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Figure 1.2 VAX Commands and Returns for Program Run 



noon ooononnonoonnononn non non no 






PROGRAM HARNESS EXAMPLE 
INTEGER MON 

INITIALIZE A RAMTEK MONITOR 

TYPE *, 'ENTER THE MONITOR NUMBER ' 
ACCEPT *, MCN 

BEGIN MANDATORY INITIALIZATION CALLS 

CALL JBEGIN 

CALL JFILES (3, 1 , MO N) 

CALL JD IN IT (1) 

CALL JD EV ON (T 
CALL JDCOLR (2 

CALL JVSPAC (-1.0. 1 .0,-.8, .8) 

CALL JWINDO (-10.0, 10. 0,-8. 0,8.0) 
CALL JROPEN 1) 



(INSERT YOUR PRIMITIVE CALLS HERE FOR 
IMAGE CREATION) 



(ALSO, INSERT YCUR REQUIRED ATTRIBUTES 
EASED UPON ATTRIEUTE CLASS AS DESCRIBED 
IN CHAPTER III.) 

• 

ALL PRIMITIVE CALLS INSERTED HERE ARE 
WITHIN OPEN RETAINED SEGMENT NUMBER 1. 



CALL JRCLOS 
CALL JPAUSE (1) 

CALL JEND 
END 

THIS PROGRAM DRAWS IN DEFAULT GREEN AND USES A 
RETAINED SEGMENT (NUMBER 1) . 



i i 



Figure 1.3 



Minimum Necessary DI-3000 Subroutine Calls. 
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II. NON-TEXT PR IMIT IVES 



A. GENERAL 

Primitive routines are used by the programmer to 
describe objects. Character-based objects (text) and 
graphics objects (non-text) are the two most common primi- 
tive types. They are distinguished not only by the images 
they create, but by how they are specified and used. This 
chapter describes non-text primitives. Chapter IV provides 
details to display text. 

As discussed in Chapter I, DI-3000 non-text primitives 
often define images in one of two ways. A figure can be 
defined using absolute world coordinate position values, or 
it can be expressed in world coordinate position values 
relative to the current position (CP). First some elemen- 
tary primitive subroutine calls will be described followed 
by examples that will illustrate the difference between 
absolute and relative expressions. 

All primitives will be created based upon the most 
recent attribute definitions. For example, if we specify 
line color to be blue, then all lines, figures, and text 
will be drawn in blue. If we wish to draw a blue line and 
then a red line, we must set the line color attribute to 
blue, draw the blue line, change the line color attribute to 
red, then draw the red line. 

Ncn-text primitives and their attributes are grouped 
into two major classes: p olyline and polygo n. Their 

differences are described in Chapter III. 
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B. MOVING THE CURRENT POSITION (JMOVE/JRMOVE) 

1 • Des cription 

JMOVE/JRMOVE are the subroutines used to move an 
invisible reference point from the current position to a new 
current position. The commands establish a reference 
position. 

2. Use 

CALL JMOVE (X,Y) (Absolute) 
or 

CALL JRMOVE(DX,DY) (Relative) 

3 • Pa rameter Def i nitio n 

X, Y (Real) 

The world coordinate position that will become the 
new current position. 

DX, D Y (Real) 

The amount cf displacement from the previous posi- 
tion to the new current position. 

4 . Discussion Example 

If the current position is at world coordinate posi- 
tion (1. 0,2.0), and we want to establish a new CP at 
(3. 0,7.0) we would use eithe r of the following subroutine 
calls : 

CALL JMOVE (3. 0,7.0) 
or 

CALL JRMOVE(2. 0,5.0) 

Note that the relative call JRMOVE merely adds its 
parameter values to the current position. For example, 
1.0+2. 0=3.0 and 2. 0+5. 0=7.0 results in the new X,Y world 
coordinates of (3. 0,7.0). The absolute call JMOVE changes 
position directly to. its parameter values. 
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Current position can be moved to X,Y coordinates 
outside the specified viewport (for example, X>10.0 or 
Y>8.0). This technique is often useful for creating unusual 
images such as "gradual" arcs of large radius, but distor- 
tion will result when the created shape reaches the viewport 
boundary. 

C. DRAWING A LINE ( JDRAW/J RDR AW) 

1 . Des cription 

JDR AW/ JR DR AW are the subroutines used to draw a 
visible line from the current position to a new current 
position. 

2 . Dse 

. CALL JDRAW ( X , 7) (Absolute) 

or 

CALL JRDRAW (D X ,D7) (Relative) 

3 . Far ame t er De f initio n 

X,T (Real) 

The world coordinate position that will become the 
new current position. A line is drawn from the old current 
position to this new CP. 

DX,DI (Real) 

The amount of displacement from the previous current 
position to the new current position. A line is drawn from 
the old CP to this new CP. 

4 . Req uir ed A tt r ibutes 

Polyline class. 
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5, Dis cus sion Example 

If the current position is at world coordinate posi- 
tion (-1.0, -4.0) and we want to draw a line from there to 
new position (2.0,0. 0) , then to a third and final position 
(5.0, -2.0) we could use either of the following subroutine 
call sequences: 

CALL J DRAW (2. 0,0.0) 

CALL JDRAW(5.0,-2.0) 
or 

CALL JRDRAW (3. 0,4. 0) 

CALL JRDRAW (3.0, -2.0) 

Any correct combination of absolute and relative 
calls could also have been used. For example: 

CALL J DRAW (2. 0,0.0) 

CALL JRDRAW (3.0, -2.0) 

Figure 2.1 shows the picture that would result from 
any of the above three call sequences. 

The attributes of the line would correspond to these 
attributes already established prior to invoking the 
JDR A w/jreraw primitives. 

Note that a color attribute must be specified by 
using the JCOLOR/JDCCLR routines as described in Chapter 
III. 

CP is changed no the final X,Y coordinate position 
cf the drawn line. 

D. DRAWING CONNECTED LINES (JPOLY/JRPOLY) 

1 . Descriptio n 

JPOLY/JRPOLY are the subroutines used to draw a 
connected sequence of visible lines, known as a pol yline 
segment . 

Note: the subroutines do not create polygons. 
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2 • Oss 



CALL JPOLY(X,Y,N) (Absolute) 
or 

CALL JRPOLY (DX,DY,N) (Relative) 

3 • Par ame t er D efinitio n 

X,Y (Real, Array) 

The arrays contain the absolute world coordinate 
positions that define the points of the polyline. 

DX,DY (Real, Array) 

The arrays contain the relative amount of displace- 
ment from the previous polyline point to the next point that 
defines the polyline. 

N (Integer) 

The number of points in the polyline segment (not to 
include the first current position point) . 

The above arrays must be dimensioned to at least the 
value of N. 

4 • Requir ed At tributes 

Polyline class. 

5 • Discussion Example 

Polylines and polygons differ in that polygons are 
always enclosed figures. Polygons are also "filled' 1 in 
color and will be described later in rhis chapter. 

Polylines are created using a single JPOLY/JRPCLY 
subroutine call rather than a sequence of JDRAW/JRDR AW calls 
as before. 

Once again we will create the image shown in Figure 
2.1, but this time only a single subroutine will be needed. 
Notice, though, that now the defining polyline coordinate 
pairs are held in array variables. Also note that the 
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initial polyline position is defined as the current posi- 
tion, (-1.0,-4.0) again, and is not included in the array 
variable coordinate pairs. Either of the following subrou- 
tines will define the required connected line: 

CALL J POLY (X , Y ,2) 

where X and Y are both two element arrays with the 
following values: 

X (1) =2. 0 Y ( 1) =0 .0 

X (2) =5. 0 Y (2) =-2.0 
or 

CALL JR POLY ( DX, DY , 2) 

where DX and DY are both two-element arrays with the 
following values: 

DX(1)=3.0 D Y (1 ) =4. 0 
DX (2) =3.0 DY (2) =-2. 0 

The above arrays must be dimensioned in the calling 
program in accordance with standard Fortran. For example: 
DIMENSION X(2) ,Y (2) ,DX(2) , DY (2) 

or 

REAL X (2) , Y (2) , DX(2) , DY (2) 

The N variable is defined as the dimension of the 
X,Y or DX, D Y arrays. Every sequence of lines consists of a 
beginning point, a series of ''breaking'' points, and an end 
point. The beginning point is the current position and is 
not included in the array variables. All other coordinate 
pairs are included. 

CP is changed to the last X,Y coordinate polyline 

point . 

E. DRAWING AN ARC LINE (J&EC) 

1 . Des criptio n 

JARC is the subroutine used to draw an arc of a 
circle. An arc line is drawn counterclockwise from one 



30 



angle position to another, with a specified radius, from a 
specified invisible circle center. 

2. Use 

CALL JARC (X, 7, 0.0, RADIUS, NS EG, AO, A1) 

3 . Parame ter Def initio n 



X, Y (Real) 

The world coordinate center of the circle from which 
the arc is to be drawn. 

0.0 (The real number zero) 

RADIUS (Real) 

The radius of the arc in world coordinates. 

NS EG (Integer) 

The number cf line segments to be used in drawing 
the arc. If NSEG<1 the arc will be smooth because the 
maximum number of segments possible will be used to draw a 
smooth curve. If NSEG>=1 then the arc will be drawn with 
NSEG flat, straight lines. 

AO, A 1 (Real) 

The angles in degrees defining the span of the arc. 
Positive angles are measured counterclockwise from the posi- 
tive X axis of the world coordinate system. Arc lines are 
drawn counterclockwise from angle AO to A1. 

4 . Req uired At tribute s 

Polyline class. 

5 . Dis cussion Example 

The JARC and JSECTR subroutines are very similar, 
and care must be taken to avoid confusing them. JARC does 
not draw a filled wedge, but merely defines a section of 
circle edge (the outside arc) . If a "pie shaped" wedge is 
desired, then the subroutine JSECTR is used. 
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If a 360 degree circle is desired, then parameters 
AO and A1 can be specified close enough together so that any 
space between them will not appear on the screen. Their 
values will be world coordinate dependent. An easier way to 
create a circle is to use the JCIRCL subroutine and specify 
"no polygon fill" as described later in this chapter. 

Note that an arc should lie within the already 
defined world coordinate window if it is to be drawn undis- 
torted. This means that very large, gradual arcs cannot be 
created simply by defining a center far away from the image 
("off the screen") . Though the large arc will have the 
correct shape through its curvature, if it exceeds the world 
coordinate viewing area it will distort at the boundary 
edge. The technique of viewing tran s formatio n should be 
used to avoid this distortion, an explanation of which can 
be found in Chapter V. 

f. DRAHING A POLYGON (JPOLGN/JRPLGN) 

1 . Des cription 

JPOLGN/JBPLGN are the subroutines used to draw 
filled or unfilled polygons. All defined points and the CP 
are connected to form an e nclosed figure. This is accom- 
plished by an "implicit" final draw from the last specified 
point in the polygon to the initial polygon creation point 

(CP) . The image can be filled with a color and pattern as 

✓ 

described in chapter III. 

Note that the subroutines can create polylines if 
the "no fill" attribute is specified, but unlike polylines, 
polygons will always define an enclosed figure. 

2. Use 

CALL JECLGN (X ,Y, N) (Absolute) 

or 

CALL JRELGN (DX ,DY,N) (Relative) 
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3 . Parame ter Definition 

X,Y (Real, Array) 

The arrays of world coordinate absolute positions 
that define the points of the polygon. 

D X,DY (Real, Array) 

The arrays cf displacement from the previous posi- 
tion to the points that define the polygon. 

N (Integer) 

The number of points in the polygon. The above 
arrays must be dimensioned by at least the value of N. 

4 • Req uire d Attr ibute s 

Polygon class. 



5 • Discus sion Ex ample 



A polygon is defined as a move from the current 
position to the first point (as specified by the array vari- 
ables X(1) ,Y(1) or DX (1) , DY ( 1) ) , draws to the remaining 
array points, and a final implicit dra w from the last point 
tack tc the first point. 

Assume we wish to draw the five sided polygon shown 
in Figure 2.2. Let current position be given initially as 
the absolute world coordinate position (1.0, 2.0). Either of 
the following subroutines will create the polygon. 



CALL JPOLGN (X, Y,5) 



where X and Y are both 
following values: 

X (1) =2. 0 
X (2) =3. 0 
X (3) =5. 0 
X (4) =6. 0 
X (5) =4. 0 



five element arrays with 

Y (1) =3.0 

Y (2) =4.0 

Y (3) =5.0 

Y (4) =3.0 

Y (5) =1.0 



the 



or 

CALL JRPLGN (DX, DY,5) 
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where DX and DY are 
the following values: 

DX (1) =1. 0 
DX (2) =1. 0 
DX (3) =2. 0 
DX (4) =1. 0 



both five element arrays with 

DY (1) =1. 0 
DY (2) =1.0 
DY (3) =1. 0 
DY (4) =-2.0 



D X (5) =-2.0 D Y (5) =-2 . 0 

Notice that relative array values merely add to the 
previous position value to create a new coordinate position. 

When JPOLGN is finished, the current position (CP) 
is set to the value of X(1),Y(1), the first point, but 
JRPLGN returns the initial CP. 

Polygons can be convex or concave. Their defining 
points can create intersecting lines, but the created shape 
will not correctly "fill" in most of those cases. Polygons 
must have at least three points. 

Note that absolute polygon routines do not use the 
CP at all. They require X,Y array specification of all 
points. Polyline routines use the CP as their first point, 
and do net include it in their X,Y arrays. 



G. ERASING A RECTANGLE (JRECT) 

1 . Des cription 

JRECT is the subroutine used to draw a horizontal/ 
vertical rectangular polygon. It is an easier subroutine to 
use than JPOLGN because only two X, Y position pair variables 
are required; the diagonally opposite corners of the 
rectangle. 

2 . Ose 



CALL JRECT (X0,Y0, XI, Y1) 
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• Parame ter De f initi o n 

X0,Y0 (Real) 

One corner of the rectangle. 

XI, Y1 (Real) 

The diagonally opposite corner of the rectangle. 

4 . Re q uir ed A tt ri butes 
Polygon class. 

5 . Dis cussion 

JRECT is included in this text as an effort-saving 
subroutine for creating horizontal/vertical rectangles. 
Note that the variables are not arrays, but merely values. 
Also, there is no counterpart subroutine with opposite 
corners defined relative to the CP. If more than one iden- 
tical rectangle is required, the JRPLGN subroutine must be 
used . 

B. DRAWING A CIRCLE (JCIRCL) 

1 . Des cription 

JCIRCL is the subroutine used to draw a circular 
polygon. The created shape is connected to form an enclosed 
figure. The image can be filled with color and pattern. 

Outlined circles can be created if no fill is specified. 

2 . Dse 

CALL JCIRCL (XO ,Y0 ,0 . 0, RADIOS , NSEG) 

3 . Parame ter D ef initi o c 

XO, Y 0 (Real) 

The center position of the circle in world 
coordinates. 
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0.0 (The real number zero) 

RADIUS (Real) 

The radius of the circle. 

NSEG (Integer) 

The number of line segments to be used when drawing 
the circle. If NSEG<3 a smooth edged circle will be 
created. If NSEG>=3, the outer edge of the circle will be 
drawn with NSEG flat, straight lines. 

4. Req uir ed Att ribute s 

Eclygon class. 

5 . D iscus s ion Example 

Figure 2.3 shows examples of figures that can be 
created using the JCIRCL subroutine. The program segment 
shown in Figure 2.4 was used to create Figure 2.3. Notice 
that triangles, squares, and any N-sided figure can be 
formed by altering the value of parameter NSEG. All images 
are oriented towards the X axis. For example, the first 
triangle tip lies on the axis at point (RADIUS, 0.. ) . 

Also note that a smooth circle was formed by setting 
NSEG= 1 , and that all the examples were drawn using the same 
center pcint and with the "no fill" attribute specified. 

For creation of circle portions, like "pie slices" 
of a circular polygon, refer to the JSECTR subroutine. For 
simple partial arc lines refer to the JARC subroutine. 

I. DRAWING A CIRCLE SECTION (JSECTR) 

1 . D escription 

JSECTR is the subroutine used to draw a section of a 
circular polygon. This shape is often used in the creation 
cf "pie charts", where part of a filled circle is needed. 
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2. Dse 



CALL J SECT R (XO,YO ,0. 0, RADIOS f NSEG, AO, A1 ) 

3 . Paramet er Def initio o 

X0,Y0 (Real) 

The world coordinate center of the circle from which 
the section is to be drawn. 

0.0 (The real number zero) 

RADIOS (Real) 

The radius of the circle section. 

NSEG (Integer) 

The number of line segments to be used when drawing 
the outer arc portion of the section. If NSEG<1 a smooth 
edge will be created. If NSEG>=1, the outer arc will be 
defined using NSEG flat, straight lines. 

AO, A 1 (Real) 

The angles, in degrees, defining the span of the 
section. Positive angles are measured counterclockwise from 
the positive X axis of the world coordinate system. 
Sections are created counterclockwise from AO to A1. 

4 . Dis cus sion E xample 

For complete 360 degree circles refer to the JCIRCL 
subroutine. For simple unfilled arc lines refer to the JARC 
subroutine. 

Figure 2.5 is an example of a circle section created 
by the following subroutine call: 

CALL JSECTR (1.0,2 .0,0. 0,3. 0,1 , 10.0,50.0) 



37 




38 



Figure 2* 1 Broken Line 
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Figure 2.2 Five-Sided Polygon 




40 



Figure 2.3 Circles 



c 

c 

c 

CALL J Cl RC 1 (0 . , 0 . ,0. ,6.5,2) 
CALL JCIRCl (0. ,0. ,0. ,5.5, 15) 
CALL JCIRCl (0. ,0. ,0. ,4.5,8) 
CALL JCIRCl 0. ,0. ,0. ,3.5,5 
CALL JCIRCl 0. ,0. ,0. ,2.5,4 i 
CALL JCIRCL(0.,0. ,0. ,1.5,3) 

0 • 

C 

c 



Figure 2.4 Circle Creation Program. 



4 1 
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Figure 2.5 Circle Section 



III. ATT RIBUTES 



A. 6EHEBAL 

Attributes define primitive image characteristics. 
Examples of attributes are "continuous" vs "dashed" lines, 
or even color itself. There are many different attributes 
possible, and they are all set using DI-3000 subroutine 
calls. The specifications described in this chapter will 
primarily apply to non-text primitives, but in several 
instances both text and non-text will share the same call. 

/ Text-only attributes are discussed in Chapter IV. 

B. DEFAULT AND CURBENT ATTRIBUTE VALUES 

Each primitive attribute has one of two values, a 
default value and a c urren t value. The default value is set 
automatically when DI-3000 is initialized (with the required 
JBEGIN subroutine) , and remains in effect unless changed 
before the fir st program segment has been opened. 

A pregram segm e nt is a program section and a graphics 
data structure. It contains a sequence of primitive calls 
that create a graphics sub-image of logically related 
objects, and is always used when creating images. Breaking 
down a complex picture into program segments simplifies the 
creation procedure and aids understanding. It is required 
in all DI-3000 programs. A detailed discussion of 
segmenting can be found in Chapter VI, but for our purposes 
the following brief example should suffice. 

Assume a programmer wishes to draw a green square in the 
upper right-hand portion of the screen, and a red semicircle 
in the center. One method for accomplishing this would be 
to create a segment for each primitive image. 
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let segment number one be for a square, and segment 
number two for a semicircle. As discussed in Chapter II we 
would use the appropriate subroutine calls for these image 
primitives within each created segment. But, so far we have 
not explained how to specify different image colors using 
DI-3000 attributes. 

Cne method would be as follows. Set the default color 
to green, begin (open) the first segment, create and display 
the square, and end (close) the first segment. Then, change 
the default color to red, open the second segment, create 
and display the semicircle, and close the second segment. 
This method would not work because DI-3000 does not permit 
changing the default color once the first segment has been 
opened. Therefore, we would have to change the c urrent 
attribute color "within'* the second segment to red. 

Any further segments would again be drawn in default 
color green, unless the current color attribute was changed 
within them. A program excerpt that creates our example is 
shown in Figure 3.1 

Default values are usually set by the programmer to the 
most common image attribute. If a complex picture will be 
predominantly of one color, then that default color will be 
set. Only images of different colors will need to be speci- 
fied later using the current color attribute calls within 
segments. 

Most default attributes are automatically set to their 
most common values when a DI-3000 program is begun and are 
usually not changed. These initial, automatic settings are 
listed in the description of each attribute call. 

Default and common attribute value subroutine calls can 
be distinguished from each ether by their format. Default 
attributes are set using the form: 

JDXXXX (e.g. JDCOLR) 

Current attribute calls are of the form: 

JXXXXX (e.g. J COLOR) 
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Current attribute values can be changed as often as 
necessary within segments. 

C. POLYLINE AND POLYGON ATTRIBUTE CLASSES 

Non-text attributes apply to either polygon or polyline 
primitive images and are classified as such. As described 
in Chapter II, polygon images always result in the creation 
of an enclosed figure, while polyline images do not 
nece ssarily. 

Throughout this chapter, a detailed description of the 
polyline class will first be given, followed by the polygon 
class. Attribute characteristics are listed by these two 
classes in the primitive- descriptions in Chapter II. 
Therefore, a programmer can first refer to the discussion in 
Chapter II of the image to be created, then cross-reference 
to this chapter by attribute class for methods that will 
specify image characteristics. 

D. POLYLINE COLOR ( JCOLOR/ JDCOLR) 

1 • Descri ption 

JCCLOR/JDCOLB are the subroutines used to set the 
current/default polyline primitive color attribute. 

2 . Use 

CALL JCOLOR (C VALUE) (Current) 

or 

CALL JDCOLR (D VALUE) (Default) 

3 . Par ame t er De f initi o n 

CVALUE (Integer) 

The color index of subseguent primitives within the 
currently open segment. (0<CVALUE<8) 

DVALUE (Integer) 
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The new value for the default color index. When a 
segment is opened, the color index is set to DVALUE. 
(0<DVAL0E<8) 

4 . Applic a bili ty 

Applies to draws, polylines, polygon edges, and text 
primitives. 

5 . Ini tia lization Def a ult Valu e 

DVAL0E=0 (Background color) 

6 . Discus sion 

The following eight entries in the color lookup 
table are downloaded to the graphics processor by setting 
CVALOE/DVALOE to any cf the following integer values: 

0 — Background (No color) 

1 — Red 

2 — Green 

3 — Yellow 

4 — Magenta (Dark Blue) 

5 — Purple 

6 — Cyan (Light Blue) 

7 — White 

8 — Background complement (White also) 

JDCOLR at program beginning or JCOLOR within each 

segment mus t be specified. If not, no image will appear, 
because JDCOLR initialization default value is 0 and primi- 
tives will be drawn in background color. 

The default entries in the color table are limited 
as described (at present) . Ramtek is capable of creating 
many different colors (any hue, lightness, or saturation 
desired) , but for simplicity in this tutorial a discussion 
cf how to accomplish this is not included. For further 
information, refer to the Reference 1 description of 
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subroutine JCOTBL (creating a color table) . 

(OSCVALOE/DVALUES327 67) is the actual range of permissible 
values, but to utilize any value >8 your color table must 
first be defined. If this definition is not done, the 
colors called by values >8 will be unpredictable. 

E. POLYLINE STYLE ( JLSTYL/JDLSTY) 

1 . De s cription 

JLSTYL/JDLSTY are the subroutines used to set the 
current/default polyline primitive line style attribute. 
Lines can be continucus or a combination of varying lengths 
of "dotted” or "dashed" portions. 

2 . Ose 

CALL JLSTYL (C VALUE) (Current) 

or 

CALL JDLSTY (D VALUE) (Default) 

3 . Parame t er D efinitio n 

CVALDE (Integer) 

The line style of subsequent primitives within the 
currently open segment. (0 SCV AL0ES32767) 

DVALUE (Integer) 

The new value for the default line style. When a 
segment is opened, the line style is reset to DV ALOE. 

(OSD VALUES 3 276 7) 

4 . Applic a bil ity 

Applies to pclyline primitives only. Does not apply 
to polygon edges, or any text. 
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5* Ini tia l iza tion Default Value 

DVAL0E=0 (Solid line) 

6 . Discussion 

The Ramtek provides a multitude of different line 
styles. As CV ALOE/ D VALUE values are increased the spacing 
between "dots" and "dashes" increases, as does their length 
and sequence. Every value that is a multiple of 8 will 
result in a solid line, with a new combination of styles to 
follow. It is best to experiment with available values to 
find the exact desired line style, but in general a value of 
CVALUE/D VALUE=7 gives a good "dotted" line that is easily 
distinguishable from normal "solid" lines. 

F. POLYLINE INTENSITY ( JINTEN/JDINTE) 

1 . Dis cussion 

JINTEN/JDINTE do not alter line intensity as 

described in Reference 1. To vary intensity, a color table 

must be created. 

G. POLYLINE WIDTH ( JLHIDE/ JDLWID) 

1 . Discuss ion 

JLWIDE/JDLWID do not alter line width as described 
in Reference 1. To vary line width, the JWINDO command must 
be used to "blow up" or "shrink" image size by changing 
world coordinate size. This technique is explained in 
Chapter V. 
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H. POLYGON EDGE COLOR STYLE ( JPEDG E/JDPEDG) 



1 . Descriptio n 

JPEDGE/JDPEDG are the subroutines used to set the 
current/default polygon edge (border) color style. Edge 
color style is of two types: "same as" or "different than" 

polygon interior colcr. 

2 • Ds e 

CALL JEEDGE(C VALUE) (Current) 

or 

CALL JEEEDG (D V ALUE) (Default) 

3 . Parame t er Def initio n 

CVALUE (Integer) 

The polygon edge color style of subsequent polygons 
within the currently cpen segment. (0<CVALUE<327 67) 

DVALUE (Integer) 

The new value for the default polygon edge color 
style. When a segment is opened, the edge style is reset to 
DVALUE. (0<DVALUE<3 2767) 

4 . Applic a bili ty 

Applies only to polygon primitives. 

5. Initializa ti on Def a ult Valu e 

DV ALUE=0 (Border Visible) 

6 • Discussion 

Eolygons are drawn with their borders either of the 
same colcr as their interiors, or of different colors. If 
the same color is specified, the border will be invisible. 
If not, the border will form an edge of different color 
around the polygon. 
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The following CV ALOE/D VALUE values are used to 
specify edge style: 

Odd — Invisible border. 

Even — Border visible. 

The polygon edge takes on the characteristics of 
current color when visible. Therefore, polyline attribute 
JCOLCR/JDCOLR determines polygon edge color in the "Even" 
style. 

I. POLYGON INTERIOR STILE (JPINTR/JDPINT) 

1 • De s cription 

JPINTR/JDPINT are the subroutines used to set the 
current/default polygon interior style attribute. Interior 
style is either "empty" (no fill, background color) , or 
"filled" (using an interior color as specified by the 
JPIDEX/JDPIDX subroutine calls). 

2 . Use 

CALL JPINTR(C VALUE) (Current) 

or 

CALL JDPINT(D VALUE) (Default) 

3 . Parame t er Def initio ns 

CVALUE (Integer) 

The polygon interior style of subsequent polygons 
within the currently open segment. (CVALUE= 0 or 1) 

DVALUE (Integer) 

The new value for the default polygon interior 
style. When a segment is opened, the interior style is 
reset to DVALUE. (D VALUE= 0 or 1) 
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4 . Applic a bili ty 



Applies only to polygon primitives. 

5 . Ini tia l iza tion Def a ult Value 

DVAL0E=0 (No polygon fill) 

6 . Discuss ion 

Fully connected lines can be created by specifying 
the "no fill" polygon attribute. . When polygon fill is 
desired, the color of the fill is determined by using the 
JPIDEX/JDPIDX subroutines as next described in this chapter. 
Note that JCOL CR/JDCOLR do not determine polygon interior 
color. 

J. POLYGON INTEBIOE COLOR (JPIDEX/JDPIDX) 

1 . Des crip t ion 

JPIDEX/JDPIDX are the subroutines used to set the 
current/default polygon interior color. 

2 . Dse 



CALL JPIDEX (CCOLOR, 0) (Current) 

or 

CALL JDEIDX (DCOLOR, 0) (Default) 

3. Parame ter D efinitions 

CCOLOR (Integer) 

The polygon interior color of subsequent polygons 
within the currently open segment. (0<CCOLOR<8) 

DCOLOR (Integer) 

The new value for the default polygon interior 
color. When a segment is opened, the interior color is 
reset to DCOLOR. (0<DCOLOR<8) 

0 (Integer number zero) 
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Polygon interior style cannot be specified as 
described in Reference 1. Therefore, a "0" is used here as 
a placeholder only. All interiors can be •’solid" filled or 
empty. Hatching is not supported. 

4 . App lic a bil ity 

Applies only to polygon primitives. 

5. Ini tia li zation Default Valu e 

DCOLOB=0 (No interior color) 

6 . Dis cuss ion 



Polygon interior color applies only to polygons 
whose interiors have been specified as "filled" using the 
JPINTB/JDPINT subroutines with value one. Interior color is 
not specified using the JCOLOR/JDCOLR subroutines. 

The following color index table is applicable to the 
Ramtek monitors by setting CCOLOR/DCOLOR to the integer 
values: 



0 — Background (No color) 

1 -- Red 

2 — Green 

3 — Yellow 

4 — Magenta (Dark Blue) 

5 — Pur pie 

6 — Cyan (Light Blue) 

7 -- white 

8 — Background complement (White also) 
Additional colors may be specified by referring to 

the Reference 1 description of JCOTBL (creating a color 
table). (0<CCOLOR/DCOLOR< 32767) is the actual range of 
permissible values, but to utilize values >8 your color 
table must first be defined. If this definition is not 
done, the colors called by values >8 will be unpredictable. 



52 



K. POLYGON PROGRAM EXAMPLE 

Figure 3.2 is a complete program that draws a polygon 
with red interior and yellow border. 



c 

C 

C 

c 

C 

C 

c 

c 

c 

c 

c 

c 

c 



c 

c 

c 

c 

c 

c 

c 

c 



c 

c 

c 



AT THE BEGINNING OF THE PROGRAM (BEFORE THE FIRST 
SEGMENT IS OPENED) DEFAULT COLOR IS SET TO GREEN. 

CALL JDCOLR (2) 

OPEN*SEGHENT ONE FOR THE GREEN SQUARE, CREATE IT, 
TEEN CLOSE SEGMENT ONE. 



CALL JRCPEN 
CALL JMOVE ( 
CALL JDRAW ( 
CALL JDRAW ( 
CALL JDRAW ( 
CALL JDRAW] 
CALL JRCLOS 




4 

4 

5 
5 
4 



OPEN SEGMENT TWC FOR THE RED SEMI-CIRCLE. 
NOTE THAT CURRENT COLOR ATTRIBUTE IS CHANGED 
WITHIN SEGMENT TWO TO RED. CREATE THE RED 
CIRCLE, THEN CLOSE SEGMENT TWO. 



CALL JROPEN (2) 

CALL JCOLOR (1) 

CALL JARC(0.,0.,0. , 2 . ,0 , 0. , 1 80 . ) 
CALL JRCLOS 



Figure 3.1 Color Segment Program. 
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C THIS PROGRAM WILL CREATE A FIVE-SIDED POLYGON AND 
C DISPLAY IT WITH A RED INTERIOR AND YELLOW EDGE. 

C 

C INITIALIZE THE PROGRAM. DECLARE VARIABLES, AND 
C ASSIGN VALUES TO NECESSARY ARRAYS. 

C 

INTEGER MON 

REAL POSITX (5) ,POS ITYJ5) 

DATA POSITX /5. ,2. 5,-2. 5,-6. 5,7./ 

DATA POSITY /6. ,0 . , -6 . 5 , 5. ,7 . 5/ 



C DI-3000 INITIALIZATION SUBROUTINES. 

C 

TYPE *, 'ENTER THE MONITOR NUMBER' 

ACCEPT *, MON 
CALL JBEGIN 
CALL JFILES 
CALL JDINIT 
CALL JDEVON 

CALL JDCOLR LL 



C OPEN SEGMENT ONE AND DRAW THE POLYGON. 

C 

CALL JROPEN (1) 

CALL JPIDEX(1,0) ! SET INTERIOR COLOR TO RED. 
CALL JPINTR(I) '.FILL VICE NO-FILL. 

CALL JPEDGE (2) !SET EDGE STYLE EVEN SO 

!IT WILL BE VISIBLE AND WILL 
! DR AW USING JDCOLOR DEFAULT 
ICOLOR YELLOW. 

CALL JPOLGN (POSITX, POSITY, 5) ! CREATE AND DRAW 

! THE POLYGON. 

CALL JRCLOS ICLOSE SEGMENT ONE. 



C PAUSE THE PROGRAM SO THE IMAGE WILL REMAIN ON THE 
C SCREEN, THEN END THE PROGRAM. 



C 

C INITIALIZE THE RAMTEK MONITOR AND COMMENCE MANDATORY 



CALL JVSPAC 
CALL JWINDO 




C 

C 



C 

C 



CALL JPAUSE (1) 
CALL JEND 
END 



C 



Figure 3. 2 Typical Polygon Creation Program 
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IV. TEXT PRIM ITIVES AND AT TRI BOTES 



A. GENERAL 

Written text can be displayed on the Ramtek monitors. 
Subroutine calls exist that create these character primi- 
tives and control text attributes such as orientation, size, 
and type. 

DI-3000 supports four different levels of text preci - 
sion . ' This tutorial will describe the highest level, known 

as graphic arts precision text. Each character in a graphic 
arts string is "stroke generated” by DI-3000 software, 
resulting in the highest possible quality of text, rather 
than using any hardware character generator. Learning how 
to create graphic arts text is no more difficult than 
learning hew to create the lower quality types because all 
text attributes apply universally. 

If a programmer is concerned with transmitting a 
graphics program over low bandwidth communications lines, 
then high quality text creation may be excessively slow. In 
this case, refer to Reference 1 for a description of lower 
level text using the J1TEXT , J2TEXT , and J3TEXT commands. 

Text primitives are only defined at absolute positions. 
There are no corresponding relative subroutine primitive 
calls . 

B. TEXT ATTRIBUTES 

As with non-text attributes, text attributes have either 
defa ult cr curr ent values. Default values must be specified 
prior tc the opening of the first segment, and current 
values can only be changed while a segment is open (within a 
segment). For a more detailed discussion refer to Chapter 
III. 
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All text attributes apply only to text primitives. One 
non- text attribute applies to text: the polyline color 

command ( JCOLOR/JDCCLH) . A description of these color 
subroutine calls can be found in Chapter III. 

All text attributes have initialization default values. 
In all but cne case, these values are such that text attri- 
butes need not be changed because legible, normal characters 
are output. Only the character size attribute 

(JSIZE/JDSIZE) must be specified. Without its modification, 
the text will be much too small to be readable since size is 
specified in terms of world coordinate window. The 16.0 by 
20.0 convention chosen for the examples in this tutorial 
makes this size change necessary. 

C. CHEATING A CHARACTER STRING (JHTEXT) 

1 . De scrip t ion 

JHTEXT is the subroutine used to output a graphic 
arts guality text string. 

2 . Use 

CALL JHTEXT (NCHARS, STRING) 

3 . Parame ter Def initio n 

NCHARS (Integer) 

The number cf characters in the text string. 
(0<= NCHARS <=25 5) . 

STRING (Integer, Hollerith Input String) 

The actual, literal character string to be output. 
For example, a STRING value of 18HTHIS IS AN EXAMPLE would 
output THIS IS AN EXAMPLE on the monitor screen. 

Note -- STRING must be an Integer type variable. If 
your program uses CHARACTER* variable types, they must be 
converted tc integer before using them as parameters in this 
JHTEXT subroutine call. 
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STRING can also contain "sentinel" characters as 
discussed below for changing to upper or lower case, under- 
lining, cr ether special functions. 

An example of the complete JHTEXT subroutine call 
that would output the letters THIS IS AN EXAMPLE follows: 
CALL JHTEXT (18, 1 8HTHIS IS AN EXAMPLE) 

4 . Required Attr ibute s 

All text class attributes and the non-text polyline 
color attribute JCOLCR/JDCOLR apply. 

5 • Dis cus s ion Example 

Characters are drawn in current polyline color as 
defined either by JCOLOR or JDCOLR. Refer to Chapter III 
for a description of these attributes. 

If increased space between, or overlap of, charac- 
ters is desired refer to the gap attribute (JGAP/JDGAP) . 

Simple block letters are created with the initial 
default. If more artistic styles are desired, refer to the 
font attribute ( JFONT/JDFONT) • 

Initial character size will be too small to be 
legible using the normal size attribute default and the 
window of 16.0 by 20.0 chosen for this tutorial. Therefore, 
the JSIZE or JDSIZE subroutines mus t be used prior to 
writing any text unless very small world coordinate window 
size is chosen. 

Character string direction will be "left-to-right" 
unless specified differently by changing the path attribute 
(JP ATH/JDPATH) . Various angle orientations can also be 
specified by using the character base (JBASE/J DBASE) and 
character plane ( JELANE/J DPLAN) attributes discussed in 
Reference 1. 

Character justification will begin with the "lower- 
left-hand" corner of the string corresponding to the current 
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position (CP) on the screen. Any changes to justification 
can be made by changing the (JJDST/JD JUST) attributes. 

All text primitive subroutine calls return CP to its 
initial position when the call completes. 

Sentin el characters are allowed within the STRING 
parameter to specify different functions. All sentinel 
character functions are prefaced by the start command (open 
bracket, ' [*) and terminated by the end command (closed 
bracket, 'J'). The sentinel character functions are: 



Figure 
resulting outputs. 



[ BSUP] 


— 


Begin superscript 


[ESOP] 


— 


End superscript 


[ BSUB] 


— 


Begin subscript 


[ ESUB] 


— 


End subscript 


[ BOC] 


— 


Begin uppercase 


[ EUC] 


— 


End uppercase 


( BIC] 


— 


Begin lowercase 


[EIC] 


— 


End lowercase 


( BUND] 


— 


Begin underline 


[ EUNE ] 


— 


End underline 


[ FONT=n] 


— 


Change to font number 'n* 


4. 1 shows 


examples of sentinels and 



their 



D. CHARACTER SIZE ( JSIZE/J DSIZE) 

1 . De s cription 

JSIZE/JDSIZE are the subroutines that set the 
current/default text primitive character size. 

2. Use 



CALL JSIZE (CXSIZE,CYSIZE) (Current) 



or 

CALL JDSIZE(DXSI ZE , DYSIZE) (Default) 
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3 . Par ame ter D ef initi o n 



CXSIZE,C YSIZE (Real) 

The size of a character within the currently open 

segment. 

DXSIZE,D YSIZE (Real) 

The new value for the default size of a character. 
Hhen a segment is opened, character size is reset to 
DXSIZE,D YSIZE. 

CXSIZE/DXSIZ E are widths (in the X-axis direction) 
and CYSIZE/DYSIZE are heights (in the Y-axis direction). 
They are expressed as world coordinate values. 

4 . I nitializa ticn Def a ult Valu e 

DXSIZE/D YSIZE = 0.02 

5. D iscus sion 

JSIZE/JDSIZE parameters are expressed as world coor- 
dinates. Therefore, since JWINDO specifies the world coor- 
dinate grid there is a direct relationship between window 
and character size. Both dimensions will be defined in 
terms of the same units. Polyline and polygon primitives 
also use these world coordinate units. 

E. CHARACTER SPACING (JGAP/JDGAP) 

1 . Descriptio n 

JGAP/JDGAP are the subroutines that set the 
current/default text spacing (gap) between characters. 

2 . Ose 



CALL JGAP (CV ALOE) (Current) 



or 

CALL JDGAP (D VALUE) (Default) 
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. Parame ter D efiniti o ns 

CVALUE (Real) 

The spacing between characters within the currently 
open segment. (CVALUE > -1.0) 

DVALUE (Real) 

The new value for the default spacing between char- 
acters. When a segment is opened, spacing is reset to 
DV ALOE. (D VALUE > -1.0) 

4 . Ini tial ization Default Value 

DVALUE = 0.0 (Normal spacing) 

5 . Dis cuss ion 

The spacing between characters is defined as a 
multiple of character width. Therefore, if CVALU E/D VALUE = 

1.0 there will be a space between each character box equiva- 
lent to the width of a normal character (for example, an 

•N') . 

Notice that when CV ALUE/DVALUE = 0.0 there is still 

some space between characters. This is because each char- 
acter is surrounded by a c harac t er box that contains ncriral 
tad space so that text does not "run together." 

Text can be made to partially or completely overlap 
by setting CVAL UE/D VALUE < -.25. CVALUE/D VALUE = -.25 makes 
the characters "touch" each other, and CVALUE/DV ALUE = -1.0 
superimposes all characters onto a single location. 

F. CHARACTER STRING DIRECTION (JPATH/JDPATH) 

1 . Descrip t ion 

JPATH/JDPATH are the subroutines that set the 
current/default text primitive character direction (path). 
Normal direction is "left-t o-right. " 
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2 . 



Use 



CALL JPATH (C VALUE) (Current) 

or 

CALL J DEATH (D VALUE) (Default) 

3 . Par ame ter Defi nitio n 

CVALUE (Integer) 

The direction of a character string within the 
currently open segment. (CVALUE=1 thru 4) 

DVALUE (Integer) 

The new default value for character string direc- 
tion. When a segment is opened, direction is reset to 
DVALUE. (DVALUE=1 thru 4) 

4 . Initia lization Defa ult Valu e 

DVALUE=1 (left-to-right) 

5 . Discuss ion 

Character strings can be generated in four different 
directions using the JPAT H/JDPATH subroutines by setting 
their parameters to the following values: 

1 — left-tc-right (character path right) 

2 — top-to -bottom (path down) 

3 — r ight-tc-left (character path left) 

4 — bottom-to-top (path up) 

Values 3 and 4 will result in inverted characters 
unless used in conjunction with base and plane manipulation 
as discussed in Reference 1. Normal directions can be 
generated using values 1 or 2. 

Figure 4.2 is an example of the four possible path 
settings. 
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G. CHARACTER STRING JUSTIFICATION (J JUST/JDJUST) 



1 . De s cription 

JJUST/JD JUST are the subroutines that set the 
current/default text primitive character string justifica- 
tion. The justification point is the starting position of a 
character string. It lies ''within" the string (for example, 
the "lower-left-hand corner," or the "center" of the 
string). Figure 4.3 shows examples of string justification. 

2. Use 



CALL JJUST (CHORIZ,CVERT) (Current) 

or 

CALL JDJUSI(DHORIZ,DVERT) (Default) 

3 . Par ame ter Def initi o n 

CHCEIZ/CV ERT (Integer) 

The horizontal/vertical justification of a character 
string within a currently open segment. (CHORIZ ,CVERT=1 ,2, 
or 3) 

DHCRIZ/DVERT (Integer) 

The new default value for the horizontal/vertical 
character string justification. When a segment is opened, 
justification is reset to DHORIZ and D VERT. 
(DHOR IZ , DVERT= 1,2, or 3) 

4. Initialization Default Valu e 

DHORIZ, DVERT = 1 (bottom left) 

5 . Discuss ion 

Character string justification values are defined as 

follows: 

CHORIZ/DHORIZ 

1 -- left 

2 -- center 



62 



CVERT/DVERT 

1 -- bottom 

2 — center 
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3 — right 3 -- top 

The justification point refers to the position indi- 
cation "dot" shown cn the examples in Figure 4.3. when a 
text primitive string is created, this point is overlaid 
(mapped) onto current screen position (CP) , thus providing 
for nine different orientations. 



H. CHARACTER STYLE (JFONT/ JDFONT) 

1 . Des cription 

JFONT/JDFONT are the subroutines that set the 
current/default character style (font) . 

2 . Dse 



CALL JFONT (C VALUE) (Current) 
or 

CALL JDFONT (D VALUE) (Default) 

3 . Parame te r De finiti on 

CVALOE (Integer) 

The style type of a character string within a 
currently open segment. (1 <=CVAL0E<=12) 

DVALOE (Integer) 

The new default value for character style type. 
When a segment is opened, style type is. reset to DV ALOE. 
(1<=DVAL0E< = 12) 

4 • Ini tia lizati on Def a ult Valu e 

DVAL0E=1 (simplex block) 

5 . Discuss ion 

There are six different character style fonts avail- 
able. Each can be generated in block or italics (right- 
slanted) orientation. The following CVALDE/DVALOE values 
are used to specify style: 
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1 — simplex block 

2 — simplex italics 

3 — duplex block 

4 — duplex italics 

5 — complex block 

6 — complex italics 



7 -- triplex block 

8 -- triplex italics 

9 -- Greek block 

10 -- Greek italics 

11 -- script block 

12 -- script italics 



Figure 4.4 gives examples of the six basic character 
style fonts. 
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Figure 4.1 Sentinel Statements and Output Examples 








Figure 4.2 



Character String Direction Path Example 
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Figure 4.3 Text Justification Examples. 
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Figure 4.4 Graphic Precision Text Styles. 



68 



V. BEQOI RED SOBROOTINBS 



A. GENEBAL 

Figure 1.1 is an example of the minimum set of subrou- 
tine calls necessary to run any DI-3000 graphics program. 
The program harness is not meant to be an exhaustive list of 
all possible control commands, but ir does provide for all 
basic initialization, primitive creation, primitive visi- 
bility, and termination requirements. 

The remainder of this chapter will describe the commands 
listed and alternative subroutine calls if they apply. Seme 
terminclogy already defined will be used. 

B. INITIALIZATION (JEEGIN) 

1 . Des crip tion 

JBEGIN is the subroutine call used to begin the 
DI-3000 graphics portion of an application program. It sets 
all default parameter and attribute values to their initial- 
ization state. 



2. Ose 



CALL JEEGIN (No parameters) 

3 . Discuss ion 

Any Fortran statements in the application program 
may precede or follow the JBEGIN call if they adhere to the 
standard, required erder of Fortran statements and lines as 
described in Reference 2. But, JBEGIN must be the first 
DI-3000 statement. It begins the application program 
graphics section. 
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JBEGIN does not specify an output device. The 
JFILES, JDI NIT , and JDEVON commands are used after JBEGIN to 
define, initialize, and select the Ramtek monitor pair to be 
used for display. 

C. SELECTING AND OPERATING RAMTEK MONITORS 
1 . D is cussion 

The war lab has three graphics processors and two 
Ramtek monitors for each processor. Before trying to use 
one of the available units the programmer must verify that 
at least one monitor pair is not already in use. There are 
three pairs currently accessible. Figure 1.1 provides a 
typical monitor configuration. Each monitor can be identi- 
fied as belonging to monitor pair 1, 2, or 3 by the label 

beneath the screen. If you try to access a pair in use your 
program will r un-ter minate with an error. 

A program could be written that would only access a 
single monitor pair, but this would limit the user. To make 
all programs able to use all monitors, the following two 
Fortran statements are included in the Figure 1.3 program 
harness and must precede the JBEGIN call in any application 
program: 

TYPE *, 'ENTER THE MONITOR NUMBER* 

ACCEPT *, MON 

Fortran programmers may be unfamiliar with these 
statements because they are VAX-11 Fortran extensions to the 
Fortran-77 standard. TYPE merely queries the user at the 
terminal (interactively during program run) as to which 
monitor pair is intended for use. ACCEPT inputs the monitor 
number and stores it in an integer variable location named 
MON for later use in the JFILES subroutine call. 

Both screens of a monitor pair do not need to be 
energized unless you wish to display two identical pictures 
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simultaneously. Before running your program, insure that 
the two Ramtek front panel toggle switches are in the "up" 
positions and that the brightness knob is turned fully coun- 
terclockwise. There is a one minute warm-up time required 
if the screens were previously deenergized. 

D. ' DEFINING MONITOR UNIT PAIR NUMBER (JFILES) 

1 . D e s criptio n 

JFILES is the subroutine call that determines which 
Ramtek monitor pair will display the graphics image. 

2 . Usg 

CALL JFILES (CODE, 1 ,MONNUM) 

3 • Parame ter D efinitio n 

CODE (Integer) 

A code that indicates which DI-3000 internal file 
will be overridden. Normally CODE=3. If graphics input is 
to be done using the input tablets, C0DE=4 is required. 

1 (Integer number one) 

Required because of current file specification as 
implemented on the VAX operating system in the War Lab. 

HONNOM (Integer) 

The monitor pair number to be used to display the 
application program graphics picture. (MONNUM= 1,2, or 3) 

4 . Discussion 

MCNNUM can be any variable name used by the applica- 
tion program to indicate monitor pair number. If the 
program harness of Figure 1.3 is used, then MONNUM must be 
the variable named MCN: 

CALL JFILES (3,1 , BON) 
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If a user knows that a certain screen pair will 
always be used, an integer value of 1, 2, or 3 can instead 

be used as MONNtJM value. For example, if screen pair 2 were 
always to be used the following statement would apply: 

CALL J FILES (3, 1,2) 

E. INITIALIZATION AND SELECTION (JDINIT/JDEVON) 

1 . Des cription 

JDINIT and JEEVON are the subroutine calls that 
initialize and then select, respectively, display devices. 
They must be included in the mandatory sequence of DI-3000 
subroutine calls. 

2. Dse 



CALL JDINIT (M ON) (Must be in this order) 

CALL J DEV ON (MON) 

3 . Parame ter D efinitio n 

MON (Integer) 

The current version of DI-3000 assigns device number 
one to all Ramtek display monitors. This number must be 
used as the parameter value of both subroutine calls 
(MON= 1) . 

4 . Dis cus sion 

JDINIT (MON) and JDEVON(MON) must precede any default 
attribute declaration subroutines or any segments. 

P. SPECIFYING COLOR 
1 . Dis cussion 

A color must be specified if any polylines or text 
are to be visible. Either the JDCOLR subroutine prior to 
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opening the first segment, or the JCOLOR subroutine within 
each segment can be used. 

If polygons are to be created, use the polygon color 
attributes JPIDEX/JDPIDX in conjunction with the interior 
style attributes JPINTR/JDPINT. 

In general, for the beginning user it is a safe 
practice to always specify a polyline default color prior to 
opening the first segment. This is done in the Figure 1.3 
program harness example with the JDC0LR(2) subroutine call. 
Since color value 2 is used, polylines and text would be 
drawn in green. 

G. DEFINING COORDINATE ASPECT RATIO (JVSPAC) 

1 . D escription 

JVSEAC is the subroutine call that defines the 
actual Ramtek monitor screen area to be used. 

2. Use 

CALL JVSPAC (-1.0, 1.0, -.8,. 8) 

3 . Dis cuss ion 

Real number parameters -1.0, 1.0, -.8, and .8 should 
be used where indicated if the maximum screen area available 
is to be utilized. Ramtek GM859C color monitors have a 
defined virtual coordinate display area ±1.0 unit wide by 
±.8 units high, referenced to an invisible screen center 
point at (0.,0.). ether values would not fully utilize the 
available screen surface. 

Portions of the screen can be used by varying JVSPAC 
parameters. The height-to-width ratio (.8) must be iden- 
tical for these parameters and the JWINDO parameters if no 
distortion is to occur during the "mapping" of world coordi- 
nate picture onto virtual coordinate space. 
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For a further description of JVSPAC, sea Reference 

1 . 

B. DEFINING WORLD COORDINATE WINDOW (JWINDO) 

1 . D escriptio n 

JWINDO is the subroutine call that defines the world 
coordinate system. All text and image points in a program 
are referenced to this grid. 

2 . Ose 

CALL JWINDO(XMIN,XMAX,YtlIN,Y!lAX) 

3 . Parameter Def initio n 

XMIN, X MAX (Real) 

The minimum and maximum world coordinate boundaries 
in the horizontal (X-axis) direction. 

YMIN, Y MAX (Real) 

The minimum and maximum world coordinate boundaries 
in the vertical (Y-axis) direction. 

4 . Discuss ion 

The world coordinate system of this tutorial is an 
area 16.0 units high by 20.0 units across, chosen arbi- 
trarily. The following command specifies this system: 

CALL JWINDO(-10.0, 10. 0,-8. 0,8.0) 

Any real values could have been selected, but they 
would have to match the .8 height-to- width ratio, specified 
by the JVSPAC subroutine call, for no distortion to occur. 

JWINDO can be used to “blow up" or "shrink" images 
merely by changing its parameter values. For example, if a 
user wants to double the size of an image, then the JWINDO 
parameters should be halved. This is analagous to an object 
existing in some world system, then finding itself in a 
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world half the previous size. The object's size would seem 
to have doubled. 

Distortions can also be created by changing height- 
to-width ratios to values other than .8. 

JWINDO cannot be called while a segment is open. 



I. SEGMENT REQUIREMENTS 



1 • Dis cuss ion 

The JROPEN(I) and JRCLOS statements in Figure 1.3 
begin and end a retained program segment. All images must 
be created within a segment. For images that can all appear 
on the screen at once, the program harness segment state- 
ments given will be adequate. Segments, and their visi- 
bility, are discussed in detail in Chapter VI. 



J. ENDING A GRAPHICS PROGRAM (JEND/END) 



1 . Des cription 

JEND is the subroutine call that terminates the 
DI-3000 graphics portion of an application program. 

2. Dse 

CALL JEND (No parameters) 



3 . Dis cussion 

JEND must be the last DI-3000 statement in an appli- 
cation program. Any Fortran statements may precede or 
follow JEND if they adhere to the standard required order of 
Fortran statements and lines as discussed in Reference 2. 

JEND insures that the Ramtek monitors previously 
initialized and selected are de-selected and terminated. 

The END command in Figure 1.3 is a standard Fortran 
statement, and must be the last statement of any application 
program. 
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VI. DISP LAYING AN IMAGE 



A. GENEEAL 

In addition to defining the shape and position of a 
primitive, a user can control when a DI-3000 picture will be 
displayed during program run. Also, simple images can be 
combined to create complex figures, and any combination of 
statements can be grouped together to form a program segment 
that can be made visible or invisible as a unit. 

Normal execution of an application program will cause 
the DI-3000 graphics image to appear on the selected monitor 
pair, but the picture will clear immediately when the job 
ends. A description of how to " pause" a program so a 
display can be held for extended viewing is included. 

This chapter explains how to control these functions, 
and discusses some image overlay limitations associated with 
the War lab graphics system as configured. 

B. SEGMENTS 

A se gment defines part of a whole picture of logically 
related objects (a graphics data structure) . A complete 
graphics image normally consists of a sequence of segments. 

Each segment is a series of DI-3000 primitive and 
current attribute calls. Every statement that creates a 
primitive must be contained within a segment. Only default 
attribute and initialization subroutines can exist outside 
this data structure. 

An entire image creation sequence can be contained 
within a sinqle segment, but multiple segments are often 
used to partition a program into more easily understandable 
parts. This technique also aids in error diagnosis. 
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There are two segment types: t emporary and reta ined . 

Temporary segments are only displayed once. If they are 
ever cleared from the screen they cannot be restored. 
Retained segments are "named" segments that can be made 
visible and invisible as often as desired. In general, the 
retained segment offers the programmer more control over the 
picture and is the recommended type. A retained segment is 
used in the example program harness of Figure 1.3 in Chapter 
I. 

When any segment is opened, the current position (CP) is 
set to zero (0.,0.) and all attributes are reset to their 
default values. 

C. IMAGE OVERLAY LIMITATIONS 

The War Lab graphics system utilizes certain conventions 
that can be limiting if compound images are desired. For 
example, if two or more primitives occupy the same pixel 
position on a screen the resultant image color will be a 
blend of the individual colors. This problem is not easily 
overcome, but sometimes can be corrected as follows. After 
drawing the second image over all or part of the first, the 
original image is made invisible by using the JVISBL 
command. When this is done, only the overlaid portion of 

the first image will disappear. A complete display of true 
color will result fcr both, but this technique can become 
very complicated for multiple images. 

A second method involves accessing the Ramtek pixel data 
and conducting a bit-plane-erase as described in Reference 1 
under Escape Functions. Trying to "black out" color by 
drawing with background color "0" does not work because you 
will actually be drawing with "nothing." 

Polygon interiors are filled with color until they 
encounter a border, but this does not have to be the 
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polygon's own border. If another polygon edge is encoun- 
tered during the fill of an overlaying polygon, the fill 
will often stop. Again, using the JVISBL command to make 
the original, overlaid polygon invisible will often correct 
this problem because the limiting border will be removed. 

When polygons are created, their defining points can 
cause their edge lines to intersect if the point sequence is 
incorrectly specified. This intersection will actually 
create more than one polygon. When color fill is attempted 
it will stop at the first intersection point rather than 
completing the interior color of the whole shape. Defining 
the shapes as multiple polygons corrects this problem. 

D. CREATING A TEMPOBABY SEGMENT (JOPEN/JCLOSE) 

1 . Di s cussion 

JOPEN/JCLOSE are the subroutine calls that begin/end 
a temporary segment. 

2. Use 



CALL JOPEN 

(sequence of DI-3000 subroutine calls) 
CALL JCLOSE 



3 . Discussion 

Temporary segments exist only once. Refer to 
JBOP EN/JRCLCS for a discussion of retained segments. 

Refer to Section B of this chapter for a description 
of segments in general. 
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E. CREATING A RETAINED SEGMENT (JROPEM/JRCLOS) 

1 . D escription 

JROPEN/J RCLOS are the subroutine calls that 
begin/end a retained segment. 

2. Ose 



CALL JROPEN (NAME) 

(Sequence of DI-3000 subroutine calls) 

CALL J RCLOS 

3 . Parame te r Def initi o n 

NAME (Integer) 

The name of the retained segment to be opened. 
(1<NAME<32000) 

4 . Discuss ion 

Retained segments can be made visible or invisible 
using the JVISBL/JDVSEL subroutine calls. 

All retained segments can be cleared from the screen 
using the JFRAME and JVISBL subroutine calls together. 

Retained segments can be erased from memory using 
the JCLEAR subroutine call. 

Refer to Section B of this chapter for a description 
cf segments in general. 

Note -- JRCLCS does not require the name of the 
retained segment as a parameter. 

F. MAKING SEGMENTS VISIBLE (JVISBL/JDVISB) 

1 . Descriptio n 

JVISBL/ JDV IS E are the subroutines that determine the 
visitility/def ault visibility of retained segments. 
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2. Ose 



CALL JVISEL(NAME , VISFLG) (Immediate) 

or 

CALL JDVISB (VISFLG) (Default) 

3 . Par ame t er De f initi o ns 

NAHE (Integer) 

The name of the retained segment whose visibility 
attribute will be changed. 

VISFLG (Integer) 

An integer value that controls the visibility of 
retained segments. <VISFLG=0 or 1) 

Default value is one (visible). 

4 . Dis cuss ion 

The following VISFLG values apply: 

0 -- Retained segment invisible 

1 -- Retained segment visible 

JVISBL is used to remove or restore the image of a 
retained segment onto the screen. 

JDVISB sets the default visibility of all retained 
segments. 

Note -- Neither subroutines can be called within a 
segment (JVISBL is net a current subroutine call) . 

Both JVISBL and JDVISB can make segments visible and 
invisible. 

G. CLEAEING THE SCREEN (JFRAME) 

1 . Descriptio n 

JFRAME is the subroutine used to clear the monitor 
screen in preparation for a new drawing area within a 
program. 
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2 . Use 



CALL JERAME (No parameters) 

3 . D iscuss ion 

JFRAME will cause all temporary segments to be 
removed from the screen. All retained segments will be 

removed, then will be redrawn based upon their visibility 
attribute as specified by J VISBL/JDVISB. 

JCLEAR will not only remove all retained segments 
from the screen, but will erase them from memory as well. 
After using JCLEAR a retained segment cannot be displayed 
again. Reference 1 contains a detailed description of 
JCLEAR. 



B. PAUSING A PROGRAM (JPAUSE) 

1 . Des criptio n 

JPAUSE is the subroutine used to pause a graphics 
program during execution. 

2. Use 

CALL JPAUSE(I) 



3 • Parame t er D ef initio n 

1 (Integer number one) 

Required by operating system device assignment. 

4 . Discussion 

The JPAUSE statement can be inserted anywhere in a 
DI-3000 program, after JDINIT and before JEND. It is used 
to hold the image on the screen for extended viewing. 

A request message will appear on the VT-100/2 screen 
during the pause. Depressing the return key on the terminal 
will cause the program to continue. 
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Every application program should include at least 
one JP&tJSE statement after all segments have been created. 
If the program is not "paused” during execution, it will 
immediately exit at run- completion and the screen will 
clear . 
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71 I. CONCLUSION 



A. ADDITIONAL CAPABILITIES 

This tutorial has only described the basic graphics 
features available in the War Lab. A brief discussion of 
additional capabilities follows. Detailed explanations can 
be found in Reference 1. 

Graphics input can be read by using the logical input 
functions and the input tablet hardware. The functions 
request input from the operator and pass the values to the 
calling program. The Chart and Sketch Program, written by 
CAPT Tschudy and available to users in the War Lab, makes 
extensive use of DI-3000 input subroutines for interactive 
query and selective display. 

Scaling can be dene that results in distorted images or 
varied image sizes. All previous examples have been two- 
dimensicnal (2D) pictures, but the ability to create three- 
dimensional (3D) objects exists. The 2D or 3D images can be 
rotated throughout all possible configurations, and can be 
viewed from any translation point in space by using 

different modeling transformations. 

Each error generated in DI-3000 is assigned a "severity 
level," and a "threshold" error level can be set that will 
either terminate or allow a program to continue. This 

selective error processing feature is particularly helpful 
during program development and debugging. 

System inquiries can be made that pass current values, 
default values, modes, and status information back to the 
application program. This capability is useful in interac- 
tive programs that rely on dynamic parameters. 
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Calling programs can ''escape" to the Ramtek hardware 
itself for control of device-dependent routines. These 
escape functions often complete processes more quickly by 
using hardware routines rather than DI-3000 software. The 
immediate display of all screen "pixel" data, rather than a 
slow software update, is an example of a typical escape 
function. 

E. HELP FEATURE 

The operating system provides users with a DI-3000 
"help" feature. Printouts that discuss common graphics 
problems, and solutions to typical difficulties, are 
displayed on the terminal screens. To access the "help" 
library, after log-in type: 

HELP DI3000 

A menu will appear with topic subsections that can then 
be specified by typing the given topic name. 

In general, "help" listings are designed to aid mere 
experienced users. 

C. SAMPLE PROGRAMS 

Sample programs exist that can be used to compare 
displayed images to the Fortran listings that create them. 
Users can output the listings to their terminal screens or 
to the printer in the War Lab machine room. The graphics 
images will appear on a monitor pair that is selected in 
response to an interactive query during program run. 

To run a demonstration program, after normal user log-in 
type the following command: 

RUNDEMC (Sample Program Number) 

For example, if sample program number 2 is to be run and 
displayed on a monitor, the following complete command is 
typed and entered with a <CR> (carriage return) : 

RUNDEMO 2 
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A reguest for monitor number will then appear on the 
terminal screen. After typing the desired monitor number 
and entering it, tte demonstration program will run and 
display the image. The Ramtek monitor you choose must be 
energized and cannot already be in use. 

There are several ways to exit, or end the programs. 
Most reguire a <CR> response to a pause message, but demon- 
stration programs 21-25 contain FORTRAN PAUSE commands that 
require the following entry : 

C <CR> 



All programs can be terminated at any time by typing 
<CTRL> and Y simultaneously. 

To cause the Fortran program listing to appear on the 
terminal screen, type the following: 

TYPEDEMO (Sample Program Number) 

To stop the screen frcm "scrolling" past the program portion 
you wish to view, depress the <NO SCROLL> key. 

To print a hard copy of the Fortran listing, type the 
following: 



PRINTDEMO (Sample Program Number) 

Seme of the sample programs correspond to figures in 
this tutorial, and are indicated as such in the following 
sample program index: 



DEMO NUMBER 
1 
2 

3 

4 

5 

6 

7 

8 
9 

10 
1 1 



DESCRIPTION 
Absolute square 
4 Relative squares 
Successful polygon overlay 
Absolute broken line (Figure 2.1) 
Relative broken line (Figure 2. 1) 
Arc line 

Distorted arc (center off screen) 
Polygon (Figure 2.2) 

Rectangle 
Filled circle 
Circles (Figure 2.3) 
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12 Circle section (Figure 2.5) 

13 Text, default attributes 

14 Text, large letters 

15 Text and polygon, normal size 

16 Text, different font 

17 Text, vertical path 

18 Text, wide gap 

19 Text, overlap gap 

20 Text, base and plane change 

21 Text, italics 

22 Sine waves plot 

23 Text, base line 

24 Text, transformations 

25 Interactive Input 

1 . Sugges ted T hesis To pic s 

A student with a desire to work with the graphics 
system could contribute to War Lab system capability. 
Polygon overlay and 3D transformation features could be more 
thoroughly investigated. 

An extensive color table needs to be created. Seme 
type of interactive method for users to select desired 
colors could be developed. 

This tutorial could be made into an interactive 
program, and further documentation of the advertised DI-3000 
capabilities that are not applicable to the War Lab system 
could be generated. 
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